home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / MacOS 8 Resources / Developer Tools / Mac OS 8 Interfaces & Libraries / Interfaces / IDLIncludes / Gestalt.idl < prev    next >
Text File  |  1996-05-01  |  8KB  |  232 lines
  1. /*
  2.      File:        Gestalt.idl
  3.  
  4.      Contains:    Gestalt Interfaces.
  5.  
  6.      Version:    Technology:    System 7.5
  7.                  Release:    Universal Interfaces 3.0d3 on Copland DR1
  8.  
  9.      Copyright:    © 1984-1996 by Apple Computer, Inc.  All rights reserved.
  10.  
  11.      Bugs?:        If you find a problem with this file, send the file and version
  12.                  information (from above) and the problem description to:
  13.  
  14.                      Internet:    apple.bugs@applelink.apple.com
  15.                      AppleLink:    APPLE.BUGS
  16.  
  17. */
  18. #ifndef __GESTALT_IDL__
  19. #define __GESTALT_IDL__
  20.  
  21. #include <somobj.idl>
  22. #include <somcls.idl>
  23.  
  24. #ifndef __TYPES_IDL__
  25. #include <Types.idl>
  26. #endif
  27. #ifndef __MIXEDMODE_IDL__
  28. #include <MixedMode.idl>
  29. #endif
  30.  
  31. #ifdef __SOMIDL__
  32.  
  33. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  34. typedef OpaquePtr SelectorFunctionProcPtr;
  35. typedef OpaquePtr SelectorFunctionUPP;
  36. #endif
  37. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  38. #endif
  39. #if FOR_SYSTEM7_AND_SYSTEM8_DEPRECATED
  40. #endif
  41. #if FOR_SYSTEM7_AND_SYSTEM8_DEPRECATED
  42. #endif
  43. #if FOR_SYSTEM7_AND_SYSTEM8_COOPERATIVE
  44. /*    These functions are built into System 7.5, but not on earlier systems*/
  45. #endif
  46. #if FOR_SYSTEM8_COOPERATIVE
  47. typedef OpaquePtr                GestaltIteratorRef;
  48.  
  49. #endif
  50. #if FOR_SYSTEM8_COOPERATIVE
  51. #endif
  52. #if FOR_SYSTEM7_AND_SYSTEM8_DEPRECATED
  53. #endif
  54. #if !OLDROUTINELOCATIONS
  55. /*    Environs Equates*/
  56. typedef SOMLargeStruct            SysEnvRec;                    /* Derived from a struct of 16 bytes in size */
  57.  
  58. #if FOR_SYSTEM7_AND_SYSTEM8_DEPRECATED
  59. #endif
  60. #endif
  61. /* Environment Selectors */
  62. /*
  63.     FORMAT OF gestaltATalkVersion RESPONSE
  64.     --------------------------------------
  65.     The version is stored in the high three bytes of the response value.  Let us number
  66.     the bytes in the response value from 0 to 3, where 0 is the least-significant byte.
  67.     
  68.         Byte#:       3 2 1 0
  69.         Value:    0xMMNNRR00
  70.         
  71.     Byte 3 (MM) contains the major revision number, byte 2 (NN) contains the minor
  72.     revision number, and byte 1 (RR) contains a constant that represents the release
  73.     stage.  Byte 0 always contains 0x00.  The constants for the release stages are:
  74.     
  75.         development = 0x20
  76.         alpha        = 0x40
  77.         beta        = 0x60
  78.         final        = 0x80
  79.         release        = 0x80
  80.     
  81.     For example, if you call Gestalt with the 'atkv' selector when AppleTalk version 57
  82.     is loaded, you receive the long integer response value 0x39008000.
  83. */
  84. /*
  85.     The gestaltNativeCPUtype ('cput') selector can be used to determine the
  86.     native CPU type for all Macs running System 7.5 or later.
  87.     
  88.     The 'cput' selector is not available when running System 7.0 (or earlier)
  89.     on most 68K machines.  If 'cput' is not available, then the 'proc' selector
  90.     should be used to determine the processor type.
  91.     
  92.     An application should always try the 'cput' selector first.  This is because,
  93.     on PowerPC machines, the 'proc' selector will reflect the CPU type of the
  94.     emulator's "virtual processor" rather than the native CPU type.
  95.     
  96.     The values specified below are accurate.  Prior versions of the Gestalt
  97.     interface file contained values that were off by one.
  98.     
  99.     The Quadra 840AV and the Quadra 660AV contain a bug in the ROM code that
  100.     causes the 'cput' selector to respond with the value 5.  This behavior
  101.     occurs only when running System 7.1.  System 7.5 fixes the bug by replacing
  102.     the faulty 'cput' selector function with the correct one.
  103. */
  104. #if !OLDROUTINELOCATIONS
  105. #endif
  106. /*
  107.     To obtain information about the connected keyboard(s), one should
  108.     use the ADB Manager API.  See Technical Note OV16 for details.
  109. */
  110. /*
  111.     MACHINE TYPE CONSTANTS NAMING CONVENTION
  112.     
  113.         All future machine type constant names take the following form:
  114.     
  115.             gestalt<lineName><modelNumber>
  116.             
  117.     Line Names
  118.     
  119.         The following table contains the lines currently produced by Apple and the 
  120.         lineName substrings associated with them:
  121.     
  122.             Line                        lineName
  123.             -------------------------    ------------
  124.             Macintosh LC                "MacLC"
  125.             Macintosh Performa            "Performa"
  126.             Macintosh PowerBook            "PowerBook"
  127.             Macintosh PowerBook Duo        "PowerBookDuo"
  128.             Power Macintosh                "PowerMac"
  129.             Apple Workgroup Server        "AWS"
  130.         
  131.         The following table contains lineNames for some discontinued lines:
  132.     
  133.             Line                        lineName
  134.             -------------------------    ------------
  135.             Macintosh Quadra            "MacQuadra" (preferred)
  136.                                         "Quadra" (also used, but not preferred)
  137.             Macintosh Centris            "MacCentris"
  138.     
  139.     Model Numbers
  140.     
  141.         The modelNumber is a string representing the specific model of the machine
  142.         within its particular line.  For example, for the Power Macintosh 8100/80,
  143.         the modelNumber is "8100".
  144.         
  145.         Some Performa & LC model numbers contain variations in the rightmost 1 or 2
  146.         digits to indicate different RAM and Hard Disk configurations.  A single
  147.         machine type is assigned for all variations of a specific model number.  In
  148.         this case, the modelNumber string consists of the constant leftmost part
  149.         of the model number with 0s for the variant digits.  For example, the
  150.         Performa 6115 and Performa 6116 are both return the same machine type
  151.         constant:  gestaltPerforma6100.    
  152.         
  153.         
  154.     OLD NAMING CONVENTIONS
  155.         
  156.     The "Underscore Speed" suffix
  157.         
  158.         In the past, Apple differentiated between machines that had the same model
  159.         number but different speeds.  For example, the Power Macintosh 8100/80 and
  160.         Power Macintosh 8100/100 return different machine type constants.  This is
  161.         why some existing machine type constant names take the form:
  162.     
  163.             gestalt<lineName><modelNumber>_<speed>
  164.     
  165.         e.g.
  166.     
  167.             gestaltPowerMac8100_110
  168.             gestaltPowerMac7100_80
  169.             gestaltPowerMac7100_66
  170.     
  171.         It is no longer necessary to use the "underscore speed" suffix.  Starting with
  172.         the Power Surge machines (Power Macintosh 7200, 7500, 8500 and 9500), speed is
  173.         no longer used to differentiate between machine types.  This is why a Power
  174.         Macintosh 7200/75 and a Power Macintosh 7200/90 return the same machine type
  175.         constant:  gestaltPowerMac7200.
  176.         
  177.     The "Screen Type" suffix
  178.         
  179.         All PowerBook models prior to the PowerBook 190, and all PowerBook Duo models
  180.         before the PowerBook Duo 2300 take the form:
  181.         
  182.             gestalt<lineName><modelNumber><screenType>
  183.         
  184.         Where <screenType> is "c" or the empty string.
  185.         
  186.         e.g.
  187.         
  188.             gestaltPowerBook100
  189.             gestaltPowerBookDuo280
  190.             gestaltPowerBookDuo280c
  191.             gestaltPowerBook180
  192.             gestaltPowerBook180c
  193.         
  194.         Starting with the PowerBook 190 series and the PowerBook Duo 2300 series, machine
  195.         types are no longer differentiated based on screen type.  This is why a PowerBook
  196.         5300cs/100 and a PowerBook 5300c/100 both return the same machine type constant:
  197.         gestaltPowerBook5300.
  198.     
  199.         Macintosh LC 630                gestaltMacLC630
  200.         Macintosh Performa 6200            gestaltPerforma6200
  201.         Macintosh Quadra 700            gestaltQuadra700
  202.         Macintosh PowerBook 5300        gestaltPowerBook5300
  203.         Macintosh PowerBook Duo 2300    gestaltPowerBookDuo2300
  204.         Power Macintosh 8500            gestaltPowerMac8500
  205. */
  206. /*
  207.     The name gestaltMixedModeVersion for the 'mixd' selector is semantically incorrect.
  208.     The same selector has been renamed gestaltMixedModeAttr to properly reflect the
  209.     Inside Mac: PowerPC System Software documentation.  The gestaltMixedModeVersion
  210.     symbol has been preserved only for backwards compatibility.
  211.  
  212.     Developers are forewarned that gestaltMixedModeVersion has a limited lifespan and
  213.     will be removed in a future release of the Interfaces.
  214.  
  215.     For the first version of Mixed Mode, both meanings of the 'mixd' selector are
  216.     functionally identical.  They both return 0x00000001.  In subsequent versions
  217.     of Mixed Mode, however, the 'mixd' selector will not respond with an increasing
  218.     version number, but rather, with 32 attribute bits with various meanings.
  219. */
  220. /*
  221.  * PPC will return the combination of following bit fields.
  222.  * e.g. gestaltPPCSupportsRealTime +gestaltPPCSupportsIncoming + gestaltPPCSupportsOutGoing
  223.  * indicates PPC is cuurently is only supports real time delivery
  224.  * and both incoming and outgoing network sessions are allowed.
  225.  * By default local real time delivery is supported as long as PPCInit has been called.
  226. */
  227.  
  228. #endif /* __SOMIDL__ */
  229.  
  230. #endif /* __GESTALT_IDL__ */
  231.  
  232.